Changes

New bns pipeline logs command

• Added command to fetch and display workflow job logs from External API
• Supports automatic environment-to-job discovery (no --job flag required)
• Multiple output formats: stylish (colored), json, yaml, raw
• Log filtering by step name (--step flag)
• Tail support to show last N lines (--tail flag)
• Follow mode placeholder (--follow flag)

HTTP client for External API

• New API client in pkg/api/workflow_job/logs.go
• Supports pagination with automatic page fetching via FetchAllPages()
• Merges logs across pages when steps span multiple pages
• Endpoint: GET /v1/workflow_jobs/{id}/logs?offset=0&limit=1000

Automatic workflow job discovery

• Queries /v1/workflows?environment={id} to find latest workflow
• Extracts most recent job ID from workflow's jobs array
• Falls back to --job flag for explicit job selection

Output formatters

• Stylish: Color-coded output with step headers and timestamps
• JSON: Structured JSON output for programmatic parsing
• YAML: Human-readable YAML format
• Raw: Plain text log messages only

API fixes

• Fixed API path: /api/v1/workflow-jobs/ → /v1/workflow_jobs/ (External API convention)
• Fixed authentication: Authorization: Bearer → X-Auth-Token header
• Added default scheme https when profile scheme is empty
• Added minimal debug output with --debug flag

Usage

# Automatic job discovery (finds latest job for environment)
bns pipeline logs my-env

# Follow logs in real-time
bns pipeline logs my-env --follow

# Filter by specific step
bns pipeline logs my-env --step "Deploy webserver"

# Show last 50 log lines
bns pipeline logs my-env --tail 50

# JSON output
bns pipeline logs my-env --output json

# Debug mode (shows API requests)
bns pipeline logs my-env --debug

# Explicit job ID (skips automatic discovery)
bns pipeline logs my-env --job 12

Error Handling

User-friendly error messages for:
- 404: Workflow job not found or no logs available
- 401: Authentication failed (prompts to run bns configure)
- 403: Access forbidden
- 429: Rate limit exceeded
- 502: Unable to retrieve log file from storage

Dependencies

Requires backend PR with:
- /v1/workflow_jobs/{id}/logs endpoint
- getJobs() method in WorkflowResource


ToDo:

Switch to using the SDK instead of using the API directly for WorkflowJobs, Logs (once the SDK is updated)